Skip to content

[v3-1-test] Warn instead of failing on missing 3rd-party doc inventor…#63646

Merged
potiuk merged 1 commit into
v3-1-testfrom
backport-afda438-v3-1-test
Mar 15, 2026
Merged

[v3-1-test] Warn instead of failing on missing 3rd-party doc inventor…#63646
potiuk merged 1 commit into
v3-1-testfrom
backport-afda438-v3-1-test

Conversation

@potiuk

@potiuk potiuk commented Mar 15, 2026

Copy link
Copy Markdown
Member

…ies (#63630)

  • Warn instead of failing on missing 3rd-party doc inventories

Third-party Sphinx intersphinx inventories (e.g., Pandas) are sometimes temporarily unavailable. Previously, any download failure terminated the entire doc build. Now missing 3rd-party inventories produce warnings and fall back to cached versions when available. A marker file is written for CI to detect missing inventories and send Slack notifications on canary builds. Publishing workflows fail by default but can opt out.

  • Add --fail-on-missing-third-party-inventories flag (default: off)
  • Add --clean-inventory-cache flag (--clean-build no longer deletes cache)
  • Cache inventories via stash action in CI and publish workflows
  • Send Slack warning on canary builds when inventories are missing
  • Add documentation for inventory cache handling options

Document the new --clean-inventory-cache, --fail-on-missing-third-party-inventories, and --ignore-missing-inventories flags in the contributing docs, Breeze developer tasks, and release management docs.

  • Skip missing third-party inventories in intersphinx mapping

When a third-party inventory file doesn't exist in the cache, skip it from the Sphinx intersphinx_mapping instead of referencing a non-existent file. This prevents Sphinx build errors when third-party inventory downloads fail.
(cherry picked from commit afda438)


Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

  • Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
  • For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

…ies (#63630)

* Warn instead of failing on missing 3rd-party doc inventories

Third-party Sphinx intersphinx inventories (e.g., Pandas) are sometimes
temporarily unavailable. Previously, any download failure terminated the
entire doc build. Now missing 3rd-party inventories produce warnings and
fall back to cached versions when available. A marker file is written for
CI to detect missing inventories and send Slack notifications on canary
builds. Publishing workflows fail by default but can opt out.

- Add --fail-on-missing-third-party-inventories flag (default: off)
- Add --clean-inventory-cache flag (--clean-build no longer deletes cache)
- Cache inventories via stash action in CI and publish workflows
- Send Slack warning on canary builds when inventories are missing

* Add documentation for inventory cache handling options

Document the new --clean-inventory-cache, --fail-on-missing-third-party-inventories,
and --ignore-missing-inventories flags in the contributing docs, Breeze developer
tasks, and release management docs.

* Skip missing third-party inventories in intersphinx mapping

When a third-party inventory file doesn't exist in the cache,
skip it from the Sphinx intersphinx_mapping instead of referencing
a non-existent file. This prevents Sphinx build errors when
third-party inventory downloads fail.
(cherry picked from commit afda438)

Co-authored-by: Jarek Potiuk <jarek@potiuk.com>
@potiuk potiuk force-pushed the backport-afda438-v3-1-test branch from f2b5ffd to e39c721 Compare March 15, 2026 14:20
@potiuk potiuk merged commit d29f532 into v3-1-test Mar 15, 2026
87 checks passed
@potiuk potiuk deleted the backport-afda438-v3-1-test branch March 15, 2026 20:08
vatsrahul1001 pushed a commit that referenced this pull request Mar 25, 2026
…ies (#63630) (#63646)

* Warn instead of failing on missing 3rd-party doc inventories

Third-party Sphinx intersphinx inventories (e.g., Pandas) are sometimes
temporarily unavailable. Previously, any download failure terminated the
entire doc build. Now missing 3rd-party inventories produce warnings and
fall back to cached versions when available. A marker file is written for
CI to detect missing inventories and send Slack notifications on canary
builds. Publishing workflows fail by default but can opt out.

- Add --fail-on-missing-third-party-inventories flag (default: off)
- Add --clean-inventory-cache flag (--clean-build no longer deletes cache)
- Cache inventories via stash action in CI and publish workflows
- Send Slack warning on canary builds when inventories are missing

* Add documentation for inventory cache handling options

Document the new --clean-inventory-cache, --fail-on-missing-third-party-inventories,
and --ignore-missing-inventories flags in the contributing docs, Breeze developer
tasks, and release management docs.

* Skip missing third-party inventories in intersphinx mapping

When a third-party inventory file doesn't exist in the cache,
skip it from the Sphinx intersphinx_mapping instead of referencing
a non-existent file. This prevents Sphinx build errors when
third-party inventory downloads fail.
(cherry picked from commit afda438)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants